Метод IConnector::OpenConfigurationByName

Открывает конфигурацию по ее имени.

IDL

[id(102225)]
HRESULT OpenConfigurationByName(
    [in] BSTR ConfigurationName, 
    [in] AuthenticationModeEnum AuthenticationMode, 
    [in, optional] VARIANT UserName, 
    [in, optional] VARIANT UserPassword, 
    [out, retval] VARIANT_BOOL* Value
);

Параметры

Параметры	Описание
ConfigurationName	Имя конфигурации
AuthenticationMode	Режим авторизации
UserName	Имя пользователя
UserPassword	Пароль
Value	Возвращаемое значение

Возвращаемое значение

"True", если открытие конфигурации прошло успешно.

Описание

Открывает конфигурацию (IConfiguration) по имени и делает ее текущей (IConnector::CurrentConfiguration) по следующему алгоритму:

№	Описание
1.	Закрывает текущую конфигурацию, если какая-либо конфигурация уже открыта.
2.	Генерирует событие IConnectorEvents::OnBeforeOpenConfiguration.
3.	Открывает конфигурацию.
4.	Выполняет авторизацию пользователя.
5.	Генерирует событие IConnectorEvents::OnAfterOpenConfiguration.

Закрытие текущей конфигурации

Если уже была открыта какая-либо конфигурация, сначала для нее выполняет метод IConnector::CloseConfiguration, и лишь при успешном его завершении выполняет открытие новой конфигурации.

Генерация события IConnectorEvents::OnBeforeOpenConfiguration

Перед открытием конфигурации генерирует событие IConnectorEvents::OnBeforeOpenConfiguration, которое может отменить открытие конфигурации.

Авторизация пользователя

Возможны два режима авторизации: серверная авторизация и Windows-авторизация. Windows-авторизация применяется только в том случае, если этот режим авторизации поддерживается используемой СУБД. При Windows-авторизации имя пользователя и пароль игнорируются.

В случае серверной авторизации, после открытия конфигурации выполняется проверка пользователя и пароля (в случае неуспешной авторизации, генерируется ошибка). На данном этапе, если срок действия пароля истек, автоматически генерируется событие обязательного изменения пароля IConnectorEvents::OnUserPasswordExpired (в соответствии с настройками пользователя). Если пароль обновлен, генерируется новое событие IConnectorEvents::OnUserPasswordChanged и продолжается открытие конфигурации.

Генерация события IConnectorEvents::OnAfterOpenConfiguration

При успешном завершении открытия конфигурации генерируется событие IConnectorEvents::OnAfterOpenConfiguration.